健康分类数据（HealthCategoryType）# PRO

HealthCategoryType 用于表示离散型的健康状态或事件。它们通常为“是否发生”的记录（如：是否怀孕、是否进行正念训练、是否存在某种症状），适用于症状追踪、睡眠分析、生殖健康记录、环境暴露监测等场景。

#1. Apple 系统事件与健康警示

#2. 正念与健康行为记录

#3. 生殖与月经周期健康

#4. 睡眠与呼吸相关事件

#5. 症状与身体状况

#应用场景举例

• 生殖健康应用：可使用如 menstrualFlow、ovulationTestResult、pregnancy、lactation 等类型追踪月经、排卵、孕期及哺乳情况。
• 日常行为与习惯追踪：通过 mindfulSession、handwashingEvent、toothbrushingEvent 引导用户建立良好生活习惯。
• 睡眠与心率监测：结合 sleepAnalysis、sleepApneaEvent 与心律相关类型，为用户提供全面夜间与心血管健康评估。
• 症状记录与疾病管理：适用于日记类、康复类 App，记录如 fatigue、nausea、fever 等症状，便于观察病情趋势。

#示例：写入睡眠阶段记录

const sample = HealthCategorySample.create({
  type: "sleepAnalysis",
  startDate: new Date("2025-07-03T22:30:00"),
  endDate: new Date("2025-07-04T06:30:00"),
  value: HealthCategoryValueSleepAnalysis.asleepDeep
})

await Health.saveCategorySample(sample)

#示例：查询冥想记录

const results = await Health.queryCategorySamples({
  type: "mindfulSession",
  startDate: new Date("2025-07-01"),
  endDate: new Date("2025-07-05")
})

for (const session of results) {
  console.log("开始：", session.startDate)
  console.log("结束：", session.endDate)
}

#注意事项

• value 值必须使用与类型匹配的枚举类型，否则 create() 会返回 null。
• endDate 必须大于 startDate，即事件需持续至少 1 秒。
• 分类样本适合用于表示有状态变化或事件发生的健康记录。